<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
 <head>
  <meta http-equiv="content-type" content="text/html; charset=UTF-8">
  <title>预定义常量</title>
<link media="all" rel="stylesheet" type="text/css" href="styles/03e73060321a0a848018724a6c83de7f-theme-base.css" />
<link media="all" rel="stylesheet" type="text/css" href="styles/03e73060321a0a848018724a6c83de7f-theme-medium.css" />

 </head>
 <body class="docs"><div class="navbar navbar-fixed-top">
  <div class="navbar-inner clearfix">
    <ul class="nav" style="width: 100%">
      <li style="float: left;"><a href="pcre.resources.html">« 资源类型</a></li>
      <li style="float: right;"><a href="pcre.examples.html">范例 »</a></li>
    </ul>
  </div>
</div>
<div id="breadcrumbs" class="clearfix">
  <ul class="breadcrumbs-container">
    <li><a href="index.html">PHP Manual</a></li>
    <li><a href="book.pcre.html">PCRE</a></li>
    <li>预定义常量</li>
  </ul>
</div>
<div id="layout">
  <div id="layout-content"><div id="pcre.constants" class="appendix">
 <h1>预定义常量</h1>

 <p class="simpara">下列常量由此扩展定义，且仅在此扩展编译入 PHP 或在运行时动态载入时可用。</p>
 <table class="doctable table">
  <caption><strong>PREG 常量</strong></caption>
  
   <thead>
    <tr>
     <th>常量</th>
     <th>描述</th>
     <th>自哪个版本起</th>
    </tr>

   </thead>

   <tbody class="tbody">
    <tr id="constant.preg-pattern-order">
     <td><strong><code>PREG_PATTERN_ORDER</code></strong></td>
     <td>
     结果按照”规则”排序，仅用于 <span class="function"><a href="function.preg-match-all.html" class="function">preg_match_all()</a></span>，
     即 <var class="varname">$matches[0]</var> 是完整规则的匹配结果，
     <var class="varname">$matches[1]</var> 是第一个子组匹配的结果，等等。
     </td>
     <td>since</td>
    </tr>

    <tr id="constant.preg-set-order">
     <td><strong><code>PREG_SET_ORDER</code></strong></td>
     <td>
     结果按照”集合”排序，仅用于<span class="function"><a href="function.preg-match-all.html" class="function">preg_match_all()</a></span>，
     即 <var class="varname">$matches[0]</var> 保存第一次匹配结果的所有结果(包含子组)信息, 
     <var class="varname">$matches[1]</var> 保存第二次的结果信息，等等。
     </td>
     <td class="empty">&nbsp;</td>
    </tr>

    <tr id="constant.preg-offset-capture">
     <td><strong><code>PREG_OFFSET_CAPTURE</code></strong></td>
     <td>
     查看 <strong><code>PREG_SPLIT_OFFSET_CAPTURE</code></strong> 的描述。
     </td>
     <td>4.3.0</td>
    </tr>

    <tr id="constant.preg-split-no-empty">
     <td><strong><code>PREG_SPLIT_NO_EMPTY</code></strong></td>
     <td>
     这个标记告诉
     <span class="function"><a href="function.preg-split.html" class="function">preg_split()</a></span> 仅返回非空部分。
     </td>
     <td class="empty">&nbsp;</td>
    </tr>

    <tr id="constant.preg-split-delim-capture">
     <td><strong><code>PREG_SPLIT_DELIM_CAPTURE</code></strong></td>
     <td>
     这个标记告诉
     <span class="function"><a href="function.preg-split.html" class="function">preg_split()</a></span> 同时捕获括号表达式匹配到的内容。
     </td>
     <td>4.0.5</td>
    </tr>

    <tr id="constant.preg-split-offset-capture">
     <td><strong><code>PREG_SPLIT_OFFSET_CAPTURE</code></strong></td>
     <td>
     如果设置了这个标记，每次出现的匹配子串的偏移量也会被返回。注意，这会改变返回数组中的值，
     每个元素都是由匹配子串作为第
     0 个元素，它相对目标字符串的偏移量作为第
     1 个元素的数组。这个
     标记只能用于 <span class="function"><a href="function.preg-split.html" class="function">preg_split()</a></span>。
     </td>
     <td>4.3.0</td>
    </tr>

    <tr id="constant.preg-unmatched-as-null">
     <td><strong><code>PREG_UNMATCHED_AS_NULL</code></strong></td>
     <td>
      This flag tells <span class="function"><a href="function.preg-match.html" class="function">preg_match()</a></span> and
      <span class="function"><a href="function.preg-match-all.html" class="function">preg_match_all()</a></span> to include unmatched subpatterns in
      <var class="varname">$matches</var> as <strong><code>null</code></strong> values. Without this flag, unmatched
      subpatterns are reported as empty strings, as if they were empty matches.
      Setting this flag allows to distinguish between these two cases.
     </td>
     <td>7.2.0</td>
    </tr>

    <tr id="constant.preg-no-error">
     <td><strong><code>PREG_NO_ERROR</code></strong></td>
     <td>
     没有匹配错误时调用
     <span class="function"><a href="function.preg-last-error.html" class="function">preg_last_error()</a></span> 返回。
     </td>
     <td>5.2.0</td>
    </tr>

    <tr id="constant.preg-internal-error">
     <td><strong><code>PREG_INTERNAL_ERROR</code></strong></td>
     <td>
     如果有 PCRE 内部错误时调用
     <span class="function"><a href="function.preg-last-error.html" class="function">preg_last_error()</a></span> 返回。
     </td>
     <td>5.2.0</td>
    </tr>

    <tr id="constant.preg-backtrack-limit-error">
     <td><strong><code>PREG_BACKTRACK_LIMIT_ERROR</code></strong></td>
     <td>
     如果调用<a href="pcre.configuration.html#ini.pcre.backtrack-limit" class="link">回溯限制</a>超出，
     调用<span class="function"><a href="function.preg-last-error.html" class="function">preg_last_error()</a></span>时返回。
     </td>
     <td>5.2.0</td>
    </tr>

    <tr id="constant.preg-recursion-limit-error">
     <td><strong><code>PREG_RECURSION_LIMIT_ERROR</code></strong></td>
     <td>
     如果<a href="pcre.configuration.html#ini.pcre.recursion-limit" class="link">递归限制</a>超出，
     调用<span class="function"><a href="function.preg-last-error.html" class="function">preg_last_error()</a></span>时返回。
     </td>
     <td>5.2.0</td>
    </tr>

    <tr id="constant.preg-bad-utf8-error">
     <td><strong><code>PREG_BAD_UTF8_ERROR</code></strong></td>
     <td>
     如果最后一个错误时由于异常的utf-8数据(仅在运行在
     <a href="reference.pcre.pattern.modifiers.html" class="link">UTF-8 模式</a>正则表达式下可用)。
  导致的，调用<span class="function"><a href="function.preg-last-error.html" class="function">preg_last_error()</a></span>返回。
     </td>
     <td>5.2.0</td>
    </tr>

    <tr id="constant.preg-bad-utf8-offset-error">
     <td><strong><code>PREG_BAD_UTF8_OFFSET_ERROR</code></strong></td>
     <td>
     如果偏移量与合法的 UTF-8 代码不匹配(仅在运行在
     <a href="reference.pcre.pattern.modifiers.html" class="link">UTF-8 模式</a>
     正则表达式下可用)。
     调用 <span class="function"><a href="function.preg-last-error.html" class="function">preg_last_error()</a></span> 返回。
     </td>
     <td>5.3.0</td>
    </tr>

    <tr id="constant.preg-jit-stacklimit-error">
     <td><strong><code>PREG_JIT_STACKLIMIT_ERROR</code></strong></td>
     <td>
      当 PCRE 函数因 JIT 栈空间限制而失败，<span class="function"><a href="function.preg-last-error.html" class="function">preg_last_error()</a></span>
      就会返回此常量。
     </td>
     <td>7.0.0</td>
    </tr>

    <tr id="constant.pcre-version">
     <td><strong><code>PCRE_VERSION</code></strong></td>
     <td>
     PCRE版本号和发布日期(比如： &quot;<code class="literal">7.0 18-Dec-2006</code>&quot;)。
     </td>
     <td>5.2.4</td>
    </tr>

   </tbody>
  
 </table>

</div>
</div></div></body></html>